Zum Hauptinhalt springen

Debugging mit dem Run Inspector

Kein Workflow funktioniert beim ersten Versuch perfekt. Der Run Inspector ist das Werkzeug das dir zeigt, was in einem Workflow-Durchlauf passiert ist — Schritt für Schritt, Agent für Agent.

Was ist der Run Inspector?​

Der Run Inspector zeigt die Ausführungshistorie eines Workflows. Für jeden vergangenen Run siehst du:

  • Wann der Run gestartet wurde
  • Ob er erfolgreich war oder mit einem Fehler abgebrochen ist
  • Was in jeden einzelnen Agent hineingegangen ist und was herausgekommen ist

Das macht ihn zum wichtigsten Debugging-Werkzeug in 42°OS. Statt zu raten warum ein Workflow nicht funktioniert, schaust du einfach nach.

Einen Run analysieren​

  1. Öffne den Workflow dessen Runs du analysieren möchtest
  2. Wechsle zum Run Inspector
  3. Wähle den Run aus den du analysieren möchtest — bei Fehlern ist der betroffene Run meist markiert oder farblich hervorgehoben
  4. Du siehst jetzt die Liste aller Agents in diesem Run

Klicke auf einen einzelnen Agent um die Details einzusehen:

  • Eingehende Nachricht — die JSON-Struktur die der Agent als Eingabe erhalten hat
  • Ausgehende Nachricht — die JSON-Struktur die der Agent als Ausgabe weitergegeben hat
  • Fehlermeldung — falls der Agent mit einem Fehler abgebrochen ist, steht hier die Ursache

Typische Debugging-Szenarien​

Der Workflow bricht mit einem Fehler ab​

Suche im Run Inspector den Agent der rot markiert ist — das ist der Punkt wo der Fehler aufgetreten ist. Lies die Fehlermeldung und prüfe die eingehende Nachricht: Sind alle erwarteten Felder vorhanden? Haben sie das richtige Format?

Der Workflow läuft durch, aber das Ergebnis ist falsch​

Hier ist der Run Inspector besonders wertvoll: gehe die Agents von Anfang an durch und vergleiche bei jedem Schritt die ein- und ausgehende Nachricht. An irgendeinem Punkt weicht das Ergebnis von deiner Erwartung ab — das ist der Agent der das Problem verursacht.

Ein Feld fehlt in der Ausgabe​

Prüfe den Agent der das Feld eigentlich schreiben sollte. Sieh dir seine ausgehende Nachricht an — ist das Feld dort vorhanden? Wenn ja, prüfe den nachfolgenden Agent: liest er unter dem richtigen Key?

Die KI-Extraktion liefert unvollständige Ergebnisse​

Schau dir im Run Inspector die eingehende Nachricht des Generative AI Agents an — ist der Dokumentinhalt vollständig und korrekt übergeben worden? Prüfe dann die ausgehende Nachricht: was hat die KI tatsächlich geliefert? Oft liegt das Problem im Prompt, nicht in der Datenstruktur.

Mit dem Manual Message Agent gezielt testen​

Der Run Inspector ist besonders nützlich in Kombination mit dem Manual Message Agent. Du kannst damit:

  1. Eine spezifische Eingabe definieren die einen Fehlerfall reproduziert
  2. Den Workflow manuell starten
  3. Im Run Inspector genau nachvollziehen was mit dieser Eingabe passiert ist

So kannst du Fehlerfälle reproduzierbar machen und sicherstellen, dass deine Lösung tatsächlich funktioniert — ohne auf ein echtes Ereignis warten zu müssen.

Testfälle aufbewahren

Wenn du eine Manual-Message-Eingabe gefunden hast, die einen Fehler reproduziert, notiere sie. Sie ist wertvoll für spätere Tests und hilft dir sicherzustellen, dass der Fehler nach einer Änderung nicht wiederkommt.

Runs filtern und suchen​

Bei Workflows die regelmäßig laufen, sammeln sich schnell viele Runs an. Mit Filtern kannst du gezielt nach fehlgeschlagenen Runs suchen oder Runs aus einem bestimmten Zeitraum anzeigen.